home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 5 / Gold Medal Software - Volume 5 (Gold Medal) (1995).iso / utils1 / ccmdr11.arj / CCMDR.DOC next >
Text File  |  1994-11-23  |  15KB  |  361 lines
  1.  
  2.                         ▄▄▄▄ ▄▄▄▄ ▄    ▄▄▄▄ ▄▄▄▄
  3.                         █    █  █ █    █  █ █▄▄█
  4.                         █▄▄▄ █▄▄█ █▄▄▄ █▄▄█ █ █▄
  5.             ▄▄▄▄ ▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄ ▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄▄
  6.             █    █  █ █ █ █ █ █ █ █▄▄█ █ █ █  █  █ █▄   █▄▄█
  7.             █▄▄▄ █▄▄█ █ █ █ █ █ █ █  █ █ █▄█ ▄█▄▄█ █▄▄▄ █ █▄
  8.             ────────────────────────────────────────────────
  9.                      Copyright (c) 1994 Mike Laszko
  10.  
  11.  
  12.                COLOR COMMANDER SHAREWARE SOFTWARE LICENSE
  13.                ──────────────────────────────────────────
  14.       This version of Color Commander is NOT public domain or free
  15.       software, but is being distributed as "SHAREWARE" for EVALUATION
  16.       PURPOSES ONLY. Your use of this software indicates your agreement
  17.       to the terms and conditions of this License.
  18.  
  19.                            USAGE RESTRICTIONS
  20.                            ──────────────────
  21.       The author and Data Management Systems grants a limited license to
  22.       individuals to use this shareware software for a 30-day evaluation
  23.       period on a private, non-commercial basis, for the express purpose
  24.       of determining whether Color Commander is suitable for their needs.
  25.       At the end of this 30-day evaluation period, the individual must
  26.       register the program or discontinue use.
  27.  
  28.       You may freely distribute the ShareWare version of Color Commander
  29.       and are encouraged to do so provided it is in its original,
  30.       unmodified form.
  31.  
  32.       This software and documentation is protected under the United States
  33.       Copyright Laws and International Treaty Provisions. Your support of
  34.       Shareware is appreciated.
  35.  
  36.                             LIABILITY WAIVER
  37.                             ────────────────
  38.       COLOR COMMANDER IS LICENSED "AS-IS."  THE AUTHOR OR HIS AGENTS
  39.       MAKE NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT
  40.       TO THIS PROGRAM, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR
  41.       FITNESS FOR ANY PARTICULAR PURPOSE. IN PARTICULAR, IT IS NOT
  42.       GUARANTEED TO PREVENT OR DETECT DAMAGE TO YOUR DATA OR PROGRAMS.
  43.       IN NO EVENT SHALL THE AUTHOR OR HIS AGENTS BE LIABLE FOR ANY
  44.       CLAIMS FOR LOST PROFITS OR ANY DAMAGE, INCLUDING, BUT NOT LIMITED
  45.       TO, SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGE. SOME
  46.       STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR
  47.       CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY
  48.       NOT APPLY TO YOU. IN NO CASE SHALL THE AUTHOR OR HIS AGENTS'
  49.       LIABILITY EXCEED THE LICENSE FEES PAID FOR THE RIGHT TO USE THE
  50.       LICENSED SOFTWARE.
  51.  
  52.                                DISCLAIMER
  53.                                ──────────
  54.       Color Commander is a DOS "TEXT" mode VGA/SVGA utility. It is not
  55.       intended for use under windows or any other graphical user interface
  56.       (GUI). It was written and tested on an SVGA system. Use of Color
  57.       Commander on a MONOCHROME, EGA or other NON VGA/SVGA compatible
  58.       system is not supported.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.       What is Color Commander?
  66.  
  67.       Color Commander is a DOS TEXT mode (non-graphics) utility that will
  68.       enable you to change any or all of the 16 DOS colors to any one of
  69.       262,144 colors. Color Commander accesses the VGA DAC registers
  70.       directly, bypassing normal color selecting conventions.
  71.  
  72.       Color Commander will allow you to edit existing palettes or create
  73.       new ones. You can save the new palettes to disk as a .PAL file
  74.       which can be loaded into Color Commander later on, or as a .COM
  75.       file which when called will set the VGA palette directly, without
  76.       having to run Color Commander first. The .COM file can be called
  77.       from the DOS prompt or from a batch file. Choosing softer, less
  78.       glaring colors for your VGA palette will reduce eye strain and
  79.       create a more aesthetically pleasing computing environment.
  80.  
  81.       Color Commander should never permanently change or damage your VGA
  82.       hardware. It simply temporarily reprograms the color registers in
  83.       your VGA card. When your system is rebooted DOS sets the color
  84.       registers in your VGA adapter to the DOS default colors.
  85.  
  86.  
  87.  
  88.  
  89.       Text mode color under DOS:
  90.  
  91.       Under DOS each of the 16 colors that are available to your programs
  92.       are assigned a number of 0-15. Color 0 is black, color 1 is blue,
  93.       color 15 is white etc. When a program is running under DOS and it
  94.       wants to display a color, say blue for example, it selects color 1.
  95.       If you change blue to orange using Color Commander and then run your
  96.       program again, when it selects blue this time, it will display
  97.       orange instead. Your program never knows it is not displaying blue
  98.       because you have changed blue to orange at the hardware level.
  99.       Every instance of blue now becomes orange.
  100.  
  101.       A graphics program like MS Windows will reset the VGA palette when
  102.       it is run. If a custom palette is active at this time it will be
  103.       reset. When the graphics program exits to DOS it sets the palette to
  104.       the DOS default colors. Some text mode (non-graphics) programs also
  105.       reset the VGA palette. These programs will also reset your custom
  106.       palette and set DOS default colors when they exit. When you run any
  107.       of these types of programs you can re-establish your custom palette
  108.       (If you have saved it as a COM file) by typing its name at the DOS
  109.       command line or by creating a batch file, or start up Color Commander
  110.       and load the palette using the F4 function key.
  111.  
  112.       Most text mode programs do not reset the color palette when they
  113.       run so your custom palette will not be zapped. For example the
  114.       Norton Utilities and Norton Commander are well behaved programs
  115.       that do not reset the palette when they run or exit. A custom
  116.       palette should work just fine for these programs.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.       COLOR COMMANDER:
  124.  
  125.       To run Color Commander, type:
  126.  
  127.       CCMDR <enter>
  128.  
  129.       A colorful screen will then pop up informing you that you are using
  130.       the UNREGISTERED version of Color Commander and that you are required
  131.       to register it if you continue to use it. Press the escape key to exit
  132.       this screen and start Color Commander.
  133.  
  134.       Pressing the <ESC> key while in a window or pick list will abort
  135.       the function and return you to the main display screen. If in doubt
  136.       hit <ESC>.
  137.  
  138.  
  139.  
  140.       ─────────────────────────────────────────────────────────────────────
  141.       DEFINITIONS
  142.       ─────────────────────────────────────────────────────────────────────
  143.  
  144.       PALETTE         : The 16 colors that DOS and your programs use.
  145.  
  146.  
  147.       DEFAULT PALETTE : The DOS default colors that are active when your
  148.                         computer first boots up. Color Commander knows
  149.                         what the default DOS colors are so you can reset
  150.                         the palette to default at any time.
  151.  
  152.  
  153.       ACTIVE PALETTE  : The palette that is displayed at the top part of
  154.                         the screen while in Color Commander.
  155.  
  156.  
  157.       CURRENT PALETTE : The palette that was active when Color Commander
  158.                         was run. The current palette is saved internally
  159.                         by Color Commander at start up.
  160.  
  161.  
  162.       CUSTOM PALETTE  : A palette that you create using Color Commander.
  163.  
  164.  
  165.       LOAD            : When you load a palette using <F4> or <F8> it
  166.                         becomes the ACTIVE palette. You can return to the
  167.                         CURRENT palette by pressing the <F6> function key
  168.                         or the DEFAULT palette by pressing <F7>.
  169.  
  170.  
  171.       SAVE            : When you save a palette using <F2>,<F3> or ALT<S>
  172.                         the active palette is saved.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.       ─────────────────────────────────────────────────────────────────────
  179.       KEY FUNCTIONS
  180.       ─────────────────────────────────────────────────────────────────────
  181.  
  182.       <F1>             Help - display summary of commands. Press <ESC>
  183.                        to return to Color Commander.
  184.  
  185.  
  186.       <F2>             Save palette to disk as <filename>.pal. Can
  187.                        be loaded from disk later and becomes the ACTIVE
  188.                        palette. Press <ESC> to cancel.
  189.  
  190.  
  191.       <F3>             Save palette to disk as <filename>.com. Cannot be
  192.                        loaded into Color Commander, but can be executed
  193.                        from the DOS command line. Use this feature to save
  194.                        custom palettes that can be called from batch files.
  195.                        Press <ESC> to cancel.
  196.  
  197.                        For example if you create a custom palette for use
  198.                        with the Norton Commander called NCPAL.COM and a DOS
  199.                        default palette called DEFAULT.COM., the batch file
  200.                        might look like this:
  201.  
  202.                        @ECHO OFF    rem  Don't echo
  203.                        NCPAL        rem  Set the custom palette colors
  204.                        NC           rem  Call the norton commander
  205.                        DEFAULT      rem  reset colors to DOS defaults
  206.  
  207.  
  208.  
  209.       <F4>             Pop up a pick window showing all the .PAL custom
  210.                        palettes. Using the Up/Down arrow keys you can
  211.                        scroll the window. Press enter to load a palette
  212.                        or <ESC> to cancel. The loaded palette becomes the
  213.                        active palette.
  214.  
  215.  
  216.       <F5>             Reset the color selected by the cursor to the CURRENT
  217.                        palette color.
  218.  
  219.  
  220.       <F6>             Reset all palette colors (0-15) to the CURRENT palette
  221.                        colors. The ACTIVE palette becomes the CURRENT palette.
  222.  
  223.  
  224.       <F7>             Reset all palette colors (0-15) to the DOS DEFAULT
  225.                        colors. The ACTIVE palette becomes the DEFAULT
  226.                        palette.
  227.  
  228.  
  229.       <F8>             Pop up a pick window showing the internal Color
  230.                        Commander palettes. These palettes are provided to give
  231.                        you a reference or starting point for creating your own
  232.                        custom palettes. Using the Up/Down arrow keys you can
  233.                        scroll the window. Press enter to load a palette or
  234.                        <ESC> to cancel. The loaded palette becomes the
  235.                        active palette.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.       <F9>             Display an ASCII character chart. I used this chart
  243.                        while developing the Color Commander so I just left
  244.                        in. Pressing any key will bring up the next screen.
  245.                        Press <ESC> to return to Color Commander.
  246.  
  247.  
  248.       <F10>            Quit Color Commander and return to DOS. The Active
  249.                        palette remains in effect
  250.  
  251.  
  252.       ALT<C>           Display a color chart with decimal and hexadecimal
  253.                        values for each color. May be helpful to programmers,
  254.                        or if you just want to see what the new palette will
  255.                        look like in the real world.
  256.  
  257.  
  258.       ALT<S>           Save the ACTIVE palette as a PASCAL Constant statement.
  259.                        This function will be useful to programmers that want
  260.                        to manipulate the VGA palette and create their own
  261.                        colors and special effects. A TURBO PASCAL UNIT is
  262.                        available that allows you to save,load and change
  263.                        palettes from within your programs and create many
  264.                        special effects.
  265.  
  266.  
  267.       ALT<U>           Display the Color Commander registration screen.
  268.  
  269.  
  270.  
  271.  
  272.  
  273.       ─────────────────────────────────────────────────────────────────────
  274.       SPECIAL KEYS
  275.       ─────────────────────────────────────────────────────────────────────
  276.  
  277.       LEFT-ARROW          - Increase Red/Green/Blue color value.
  278.  
  279.  
  280.       RIGHT-ARROW         - Decrease Red/Green/Blue color value.
  281.  
  282.  
  283.       UP/DN-ARROW         - Select Red/Green/Blue color component.
  284.  
  285.  
  286.       INS
  287.       or
  288.       CONTROL-LEFT-ARROW  - Select 1 of 16 palette colors.
  289.  
  290.  
  291.       DEL
  292.       or
  293.       CONTROL-RIGHT-ARROW - Select 1 of 16 palette colors
  294.  
  295.  
  296.       PAGE-UP/PAGE-DOWN   - Intensity, increases or decreases
  297.                             all 3 color values.
  298.  
  299.  
  300.  
  301.  
  302.       UTILITIES AND PALETTE FILES:
  303.       ─────────────────────────────────────────────────────────────────────
  304.       I have included several PAL and COM files to give you a better idea
  305.       of what you can do with Color Commander. DEFAULT.COM is the DOS
  306.       standard (default) color palette. These are the colors that DOS sets
  307.       when your system boots up.
  308.  
  309.       Also included is a small utility called SHOPAL.EXE. It will show you
  310.       the colors of the active palette from the DOS command line.
  311.  
  312.  
  313.       NOTE:
  314.       ────
  315.       When creating a custom palette for a program it is best to start
  316.       out with a gray palette. Change one or two colors, then run your
  317.       program to see the changes. Too much color is confusing. You will
  318.       be surprised at how good many programs look with a lot of grays and
  319.       just a few colors.
  320.  
  321.  
  322.       IN THE WORKS:
  323.       ─────────────────────────────────────────────────────────────────────
  324.       An interactive version of COLOR COMMANDER is in the works. It will
  325.       allow you to change colors and create custom palettes from within
  326.       your favorite programs. No more guessing or trying to remember
  327.       which colors you want to change.
  328.  
  329.       A Turbo PASCAL Unit for programmers that will allow you to
  330.       manipulate the VGA palette from within your program. Your program
  331.       will have access to 262,144 colors and special effects such as
  332.       fade, swap, rotate and random to name just a few.
  333.  
  334.  
  335.       Author: Mike Laszko
  336.  
  337.       Modem : 1-619-728-7307
  338.  
  339.       Fax   : 1-619-728-0264
  340.  
  341.       Mail  : Data Management Systems
  342.               P.O. Box 2828
  343.               Fallbrook, Ca. 92088-2828
  344.  
  345.  
  346.       The current version of Color Commander is available for
  347.       download from:
  348.  
  349.       THE FILE BANK BBS
  350.       1-619-728-7307
  351.       1200-115,200 baud
  352.       USR 28.8 HST DS v.34
  353.  
  354.  
  355.       Note from the author:
  356.  
  357.       Comments and suggestions are always welcome. I can be reached
  358.       on the File Bank BBS. Thank you for trying Color Commander.
  359.  
  360.  
  361.